home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / os2 / pmics091.arj / README < prev   
Text File  |  1993-05-28  |  5KB  |  102 lines
  1.                 ====================================
  2.                 PMICS User Guide: version 0.9 (beta)
  3.                 ====================================
  4.  
  5. PMICS is an interface for playing chess through the Internet Chess Server.
  6. It is intended for connecting to a host system through the serial port; other
  7. modes of connecting to ICS such as direct telnet from OS/2 may be supported
  8. in the future.
  9.  
  10. PMICS comes with source (for what it's worth...) and is freely redistributable
  11. under the terms of the GNU General Public License.  The author has no
  12. connection with the Free Software Foundation, so all bugs are his
  13. responsibility.  Comments are welcome at chow@netcom.com.
  14.  
  15. -------------------
  16. Running the program
  17. -------------------
  18.  
  19. Typing "start pmics" will run the program in its own session.  By default
  20. it grabs the first openable COM port at 9600 baud.  If this auto-mode doesn't
  21. doesn't work for you, specify your COM port and baud rate explicitly with
  22. /Cn and /Pnnnn, e.g.  "start pmics /c2 /p2400" for COM2 at 2400 baud.  
  23.  
  24. After the chessboard window comes up, connect to your host system by typing
  25. your modem's dial commands (e.g. ATDTnnnmmmm).  Once you are connected to
  26. ICS enter the command "style 8" so that pmics can parse the game status
  27. messages.
  28.  
  29. If the window is not the right size, in particular if it is too big, use the
  30. command line parameters /Xnnn and /Ynnn to override the default window
  31. dimensions (currently 600x600).  An invocation suitable for VGA is
  32. "start pmics /x600 /y480".  On the other hand if you have 1024x800 resolution
  33. or better then try: "start pmics /x800 /y800 /b2".  This uses larger bitmaps.
  34.  
  35. Options summary:
  36.    /Bn                specify board size 1=normal, 2=large, 3=huge
  37.    /Cn                specify serial port to use
  38.    /Pnnnn             specify serial port baud rate    
  39.    /Dxya              specify a modem init string.  this can be a dial 
  40.                       command.  to include blanks, enclose in quotes,
  41.                       e.g. /D"ATE1 DT2419796"
  42.    /Xxxx              specify X dimension of window
  43.    /Yyyy              specify Y dimension of window
  44.    /wpc colour-spec   specify colour of white pieces
  45.                       colour-spec is either a colour name or a hex string
  46.                       of the form rrggbb specifying RGB intensity.  
  47.                   recognized colour names are: blue, red, pink, green,
  48.               cyan, yellow, neutral, darkgray, darkblue, darkred,
  49.               darkpink, darkgreen, darkcyan, brown, palegray.
  50.    /bpc colour-spec   specify colour of black pieces
  51.    /wsc colour-spec   specify colour of white squares
  52.    /bsc colour-spec   specify colour of black squares
  53.  
  54. -------------
  55. Playing chess
  56. -------------
  57.  
  58. Use the left mouse button to grab the piece you want to move and drag it to the
  59. target square.  Clicking the right button reissues the last move you made.
  60.  
  61. When the board is "locked" only ICS status messages cause it to update; this
  62. is the default.  Unlocking the board from the Board menu causes your moves
  63. to occur immediately.  The Board menu also has a Flip option to rotate the
  64. board 180 degrees.
  65.  
  66. PMICS recognizes challenge messages and pops up a requester informing you of
  67. the match parameters.  Your choices are to accept, decline, or ignore.  You can
  68. make a counter proposal by changing the time control field and pressing Accept.
  69. If you select Ignore no action is taken and the challenge remains pending.
  70.  
  71. Currently there are no options to save the game score or replay moves.
  72. (The PrintScreen key does work, after a fashion).
  73.  
  74. ------
  75. Quirks
  76. ------
  77.  
  78. The list boxes grab the focus and won't let go -- you find that pressing
  79. keys scrolls the windows madly.  Press ESC to get out of this mode.
  80.  
  81. If the displayed position gets scrozzled, or you suspect it's out of sync,
  82. first press the Refresh button on the right side of the window, then pull
  83. down the Board menu and select Replot.  (The second step is only necessary if
  84. the board is "unlocked").
  85.  
  86. --------------
  87. Update history
  88. --------------
  89. 5/28    0.91    pieces plotted illegibly on some systems; added color options
  90. 5/19    0.9     first release
  91.  
  92. ----------------
  93. Acknowledgements
  94. ----------------
  95.  
  96. PMICS was inspired by the excellent DOS interface, GIICS, written by
  97. Tony Acero.  The bitmaps for the pieces are taken from the GNU program xboard.
  98. Serial port IOCTL magic was adapted from the PD comm program comtalk.
  99.  
  100. Kevin Nomura
  101. chow@netcom.com
  102. 5/19/93